home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / xgrabsc / README < prev    next >
Text File  |  1995-05-09  |  5KB  |  147 lines
  1. *========================================================================
  2. *
  3. * Name - README
  4. *
  5. * Version:    1.12
  6. *
  7. * ccsid:    @(#)README    1.12 - 06/25/93 12:54:12
  8. * from:     ccs/s.README
  9. * date:     06/28/93 09:14:48
  10. *
  11. * Copyright (C) 1990-92 Bruce Schuchardt
  12. * See either the man page or the file cpyright.h for full copyright
  13. * information.
  14. *
  15. * Description:  README for xgrabsc
  16. *
  17. *        Notes for this specific release are in README.xx_yy
  18. *
  19. *========================================================================
  20.  
  21. INTRO TO xgrabsc
  22.  
  23. When I first wrote xgrabsc, there were a number of programs available
  24. for getting X-Window screen dumps (e.g., xwd and xwps), but they
  25. were all restricted to dumping a single window in a single format.
  26. I wrote xgrabsc in an effort to get around these restrictions.
  27.  
  28. The main contribution of this program is its use of root-window
  29. rubberbanding to allow capture of arbitrary portions of the screen,
  30. and its multiple output formats (x-bitmap, x-pixmap, xwd, puzzle,
  31. "simple", and several Postscript formats).
  32.  
  33. The Postscript dumps will use run-length encoding if it results in
  34. any savings in size.  A typical xterm window dump on a mono system
  35. runs around 40K bytes (20K for binary output).  An xwd dump on the
  36. same screen will be around 650K bytes.  While the xpr program has a
  37. "compress" option, it only compresses white samples.  Reducing the 
  38. size of the output increases the cost of computing the dump and the
  39. final printing of the dump, but it reduces the cost of storage and
  40. the time to transfer the dump to your printer.  The latter is
  41. especially important for large screen dumps.
  42.  
  43. The xgrabsc program is not interactive.  You specify all processing
  44. options on the command line with obscure option characters.  These
  45. are all detailed in the man page.  An interactive interface to xgrabsc,
  46. named xgrab, is also included in this release.  xgrab allows you to
  47. do most of the setup with a mouse, and then uses the xgrabsc program
  48. to actually do the processing.  To use xgrab you must have the xgrabsc
  49. program in your execution path.
  50.  
  51.  
  52.  
  53. OPTIONS FOR BUILDING xgrabsc
  54.  
  55. The file config.h contains all the configuration options for xgrabsc.
  56. Please take a moment to look through that file before building xgrabsc.
  57.  
  58. You also have the choice of building either the Athena or Motif 1.2 version of
  59. the xgrab form.  The default is to build the Athena version since many people
  60. don't have version 1.2 of Motif yet.  If you want to build the Motif version
  61. you will have to edit the Imakefile or simple.mak before building. 
  62.  
  63. To find out if you have Motif 1.2, look for the definition of XmREVISION in
  64. your Xm.h include file.  If it is 1, you don't have Motif 1.2. 
  65.  
  66.  
  67.  
  68.  
  69. BUILDING xgrabsc
  70.  
  71. Xgrabsc should build easily enough.  If you don't have the imake
  72. program, use simple.mak (i.e., make -f simple.mak).  There are targets
  73. for xgrabsc, xgrab, install, install.man, and clean.
  74.  
  75. E.g.,
  76.   xmkmf
  77.   make
  78.   make install
  79.   make install.man
  80.  
  81. The install target will put xgrabsc in /usr/bin/X11 and the man page in
  82. /usr/man/man1, unless you are using imake and your configuration files
  83. specify alternative directories.  If you are using simple.mak and don't
  84. like these locations, change the makefile before installing.
  85.  
  86. Please send comments, bugs, and enhancements to bruce@slc.com.  Please
  87. read the Bugs file before sending bug reports.
  88.  
  89.  
  90.  Manifest
  91.  ---------------------------------
  92.  README              this file
  93.  README.xx_yy        files describing incremental changes to xgrabsc
  94.  
  95.  Acks                acknowledgements for code gleaned from other
  96.                      systems, and people who have been very helpful
  97.                      in adding features and removing bugs from xgrabsc
  98.  
  99.  Bugs                known bugs - read this before sending bug reports
  100.  
  101.  Imakefile           Input for "imake" program
  102.  simple.mak          Simpler input for standard "make"
  103.  hp.mak             A version of simple.mak for HPUX 9.0, which comes with
  104.               Motif1.2
  105.  
  106.  checkvm.h           Memory-check Postscript operator
  107.  config.h            Configuration options
  108.  cpyright.h          Copyright notice for this software (READ IT)
  109.  cmdopts.h         Command line options for xgrabsc
  110.  patchlevel.h        Current patch level
  111.  virtual.h           Support for virtual window managers
  112.  xgrabxm.c           Source for Motif 1.2 window interface to xgrabsc
  113.  xgrabxaw.c         Source for the Athena window interface to xgrabsc
  114.  xgrabsc.c           Program source for the screen grabber
  115.  
  116.  *.hc                function include files for xgrabsc.c
  117.  
  118.  XWDfile.h           xwd structure definition needed on some platforms
  119.  
  120.  ad2c.sed            sed script to convert XGrab.ad to fallback resources
  121.                      for xgrab (see Ack file - this isn't mine)
  122.  
  123.  xgrabsc.man         Man page for xgrabsc
  124.  xgrab.man           Man page for xgrab
  125.  
  126.  XGrabxm.res         Resources for the Motif xgrab program
  127.  XGrabxaw.res         Resources for the Athena xgrab program
  128.  
  129.  
  130.  
  131. BUGS:
  132.  
  133. Common problems and known bugs are described in the Bugs file.
  134.  
  135.  
  136.  
  137. TO DO:
  138.  
  139. Support for 24-bit displays.  If someone wants to give this a shot, please
  140. let me know.
  141.  
  142.  
  143. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  144.   Bruce Schuchardt          bruce@SLC.COM
  145.   Servio Corp.
  146.   Beaverton, OR
  147.